home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / otour11d.zip / ONTOUR.DOC < prev    next >
Text File  |  1992-09-02  |  43KB  |  1,051 lines
  1.  
  2.                                   ONTOUR - page 1
  3.  
  4.  
  5.     ▄███████▄  ▄██▄   ▄██▄ ▄██████████▄  ▄███████▄  ▄██▄   ▄██▄ ▄████████▄
  6.    ████▀▀▀████ █████▄ ████ ▀▀▀▀████▀▀▀▀ ████▀▀▀████ ████   ████ ███▀   ▀███
  7.    ███     ███ ███████████     ████     ███     ███ ████   ████ ███▄   ▄███
  8.    ███     ███ ████▀██████     ████     ███     ███ ████   ████ █████████▀
  9.    ████▄▄▄████ ████  ▀████     ████     ████▄▄▄████ ███████████ ████ ▀████▄
  10.     ▀███████▀  ▀██▀   ▀██▀     ▀██▀      ▀███████▀   ▀███████▀  ▀██▀   ▀██▀
  11.                                    Version 1.10c
  12.     ─────────────────────────────────────────────   ──── ┌┬────.
  13.                                                    ─════ ││     \
  14.     The sysop is not at home! So we must do         -═══ ││      ╘──────
  15.         the correspondence for him!               ──────`│-════       -
  16.             HE IS --- ON TOUR!                      ─═══─ \           ┌
  17.                                                        ─── `─═════════┴
  18.     ─────────────────────────────────────────────────
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.            This program and the documentation is copyrighted material.
  26.  
  27.                  It is (c) by PBS - Peter Hampf, FIDO 2:240/11 --
  28.                                all rights reserved.
  29.  
  30.              Original visual interface concept designed by Joaquim H.
  31.                        Homrighausen. Used with permission.
  32.  
  33.        Ok,  let's start now  with the  discussion about the  sense of this
  34.        program.  But NOTE: writing a documentation  is not the finest job,
  35.        so  please let me make it  fast and small ...  (reading the docs is
  36.        not the finest, too, I think...)
  37.  
  38.        Note: The changes since Version 1.00 are NOT shown. Please read
  39.        the WHATSNEW - file.
  40.  
  41.  
  42.  
  43.  
  44.  
  45.         │ 1. part of the journey.
  46.         │ What it is ....
  47.         └─────────────────────────────────────────────
  48.  
  49.        You  know  the  problem?  You  are  on  vacation and  thousands  of
  50.        netmails  are reaching your system with  thousands of people in the
  51.        background  who  are sitting  in front  of  their computer  and are
  52.        awaiting your response :-)
  53.  
  54.        Why  not tell  them, that you  can't answer  right now but  will do
  55.        this later? Nothing easier than this!
  56.  
  57.        That  is the moment for  ONTOUR coming on the  plan ... Please give
  58.        this program a try.
  59.  
  60.        ONTOUR will  scan your netmail folder for mails addressed to one of
  61.        10  definable names. (e.g. YOU and your  alien-names) If there is a
  62.        mail  to one of  this names,  ONTOUR will generate  a response mail
  63.        and  OPTIONALLY mark the  original mail as received  AND/OR move it
  64.        to  another directory. You  can define up to  15 specific template-
  65.        files  (see later in  this document) for 15  nodes. All other nodes
  66.        will get the standard template (which must be defined, too).
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                                  ONTOUR - page 2
  73.  
  74.         │ 2. part of the journey.
  75.         │ The Setup
  76.         └─────────────────────────────────────────────
  77.  
  78.        The  SETUP is  quite  as easy.  A fullscreen-setup  program, called
  79.        S_ONTOUR is  part of the ONTOUR package. Please run this program at
  80.        once - and  every time you plan a new vacation (because the CRCFile
  81.        - see later - must be updated...).
  82.  
  83.        Now  fill in all  the needed  fields. In line  25 you get  a little
  84.        help. If one line is marked as MANDATORY, you *MUST* fill it out.
  85.  
  86.  
  87.  
  88.        Please start with the SYSTEM PARAMETERS:
  89.  
  90.        o if  you specify your NAME  in the first field,  THIS name will be
  91.          used  as  the  addressee  of  your  response mail  otherwise  the
  92.          ORIGINAL  TO-name  will  be  used!  (e.g.  one of  your  'alien'-
  93.          names?!)
  94.  
  95.        o the path to your mailer's netmail ...
  96.  
  97.        o if you  specify a move-path here (AND ONLY IF), all ANSWERED mail
  98.          will  be moved  to  this path.  If any  mail is  disqualified for
  99.          answering  (excluded  person/text,  cosysop  ...)  it  will  stay
  100.          untouched in your mailer's netmail-path.
  101.  
  102.          There is one  exception: if you have set the ONCE-ONLY - flag and
  103.          there  comes another netmail from one  person who had already got
  104.          a response, this mail will be moved, too!
  105.  
  106.        o your STANDARD-TEXTFILE.  If you receive a netmail from a node not
  107.          listed  in the node-window,  this template  will be sent  to him.
  108.          PLEASE DEFINE  ONE, IF YOU DO NOT, A STANDARD (ENGLISH) TEXT WILL
  109.          BE   SENT  OUT!!!  An   example  is  included   in  this  package
  110.          (EXAMPLE.DTB).
  111.  
  112.          NOTE:  you CAN define an own TEARLINE  in your template. But only
  113.          if  you are a  registered user, ONTOUR will  NOT insert it's own!
  114.          If you  define a tearline (a line starting with three dashes) and
  115.          are not registered, your message will have two tearlines..... .
  116.  
  117.        o your DELAY-TEXTFILE.  This textfile has a special meaning: if you
  118.          are at  home (AT HOME=YES) *AND* you have defined an answer-delay
  119.          (see  BEHAVIOUR) then  this  textfile is  used for  answering the
  120.          mails.  No  special-textfile-matching will  be  done!!!  (You may
  121.          leave  this entry blank. In that  case the standard-textfile will
  122.          be used or a special textfile - if the calling node has one!)
  123.  
  124.        o your  TEXTFILE-DIRECTORY.  ALL  (!)  defined  textfiles  have  to
  125.          reside here!!!
  126.  
  127.        o name of  CRCFile. ONTOUR will calculate a CRC32-Checksum of every
  128.          answered  mail  and store  this  checksum in  the  file specified
  129.          here. THIS  IS RECOMMENDED! ONTOUR has the capability to store up
  130.          to 1000 CRCs - enough for the most cases.
  131.  
  132.          NOTE:  if ONTOUR reaches the 1000st mail,  the first 100 CRC will
  133.          be deleted.  So you can be sure, that at  least 900 CRCs are EVER
  134.          present! (Like  a ring-counter...) If you are back from vacation,
  135.          you can (but MUST  not do it) create a new CRC-file for your next
  136.          journey ;-)  (simply enter S_ONTOUR and walk into the field "Name
  137.          of  CRC-file" -- the  rest is automatism  :-))    --- In addition
  138.          you  have the capability to mark  all answered mails as received!
  139.  
  140.  
  141.  
  142.                                  ONTOUR - page 3
  143.  
  144.          This is  the second secure way to prevent dupes! The third method
  145.          automatically  used  by  ONTOUR  is  the  checking of  the  mails
  146.          timestamp.  Only  new mail  will  be processed  by  default. (See
  147.          below, parameter /F)
  148.  
  149.        o your  mailer's  rescan-semaphore file.  If  specified,  this file
  150.          will  be  touched  or  rewritten  every  time  a new  message  is
  151.          generated.  So this  message could  be send out  immediately with
  152.          your next automatic poll.
  153.  
  154.        o your mailer's  INBOUND. This path is only needed for locating the
  155.          REMOTE-MAINTAINANCE-FILE  called OTREMOTE. If  you want to switch
  156.          ONTOUR's  behaviour from  remote,  you have  to do  the following
  157.          steps:
  158.  
  159.          - set up this path
  160.  
  161.          - define a PASSWORD (see below)
  162.  
  163.          - go ON TOUR ;-)
  164.  
  165.          - send  a textfile to  your own  system. This textfile  must have
  166.            the name  "OTREMOTE" without any extension. The first line MUST
  167.            contain  your   password.  The  other  lines  may  contain  the
  168.            following (note, that wrong lines simply will be ignored!):
  169.  
  170.             ATHOME=YES/NO             (Yes or no;-)
  171.             DELAY=xxx                 (xxx = 0 to 255 days)
  172.             ONCEONLY=YES/NO           (only one answer to a 'writer'?)
  173.             COPYONLY=YES/NO           (ONLY copy to cosysop, no answer?)
  174.             CRASH=crash/direct/
  175.                   route/dontanswer    (set the behaviour on CRASH-mails!)
  176.             COSYSOP=name              (New name of COSYSOP to copy to!)
  177.             COSYSOPADDRESS=<fidoaddr> (and his FIDO-address)
  178.                     ^^ be aware of this TWO Ds :-))
  179.  
  180.        o LOG-file.  Specify a logfile  if you  want ONTOUR to  write which
  181.          mails have been answered.
  182.  
  183.        o external  EDITOR: if  defined,  you have  the capability  to edit
  184.          your  TEMPLATES from within  ONTOUR -  SETUP. You can  supply any
  185.          name,  including .BAT -  files. A .BAT-file will  be executed via
  186.          your  command-processor (make  sure that the  COMSPEC environment
  187.          variable is set!).
  188.  
  189.        o EMS/XMS  swapping: when  editing a  template, S_ONTOUR  will swap
  190.          out  the  most of  the  memory either  to  EMS, XMS  or  to DISK.
  191.          Specify YES  if you want to use the  EMS/XMS method! (If you have
  192.          EMS installed!)  If set to NO, a swapping file will be generated.
  193.          If there  is not enough memory, S_ONTOUR will notify you with the
  194.          error-number 257!
  195.  
  196.        o REMOTE-PASSWORD:  the remote-maintainance  is only  available, if
  197.          you  specify  a password  here!  (Ooo, sorry,  I  forgot: REMOTE-
  198.          MAINTAINANCE is a registered-only-feature..., sorry)
  199.  
  200.  
  201.  
  202.        Ontour's BEHAVIOUR:
  203.  
  204.        o the  LOCAL-mail  switch  qualifies  LOCALLY  generated mails  for
  205.          processing,  too. Note that  you can  TOGGLE the setting  of this
  206.          switch by using the /L commandline parameter!
  207.  
  208.  
  209.  
  210.  
  211.  
  212.                                  ONTOUR - page 4
  213.  
  214.        o within  the next fields  you can specify, whether  to generate an
  215.          INTL-Kludge line  in your response-mails. This affects only mails
  216.          from  your  OWN zone!  Foreign-zone  messages will  ever  have an
  217.          INTL-LINE. (NOTE:  the ZONEGATE-handling will be implemented in a
  218.          later version, it isn't until now!)
  219.  
  220.        o FOREIGN-ZONES: if  set to YES, ALL mails from other zones will be
  221.          answered.  If you have  defined an AKA in  the AKA-matching table
  222.          (see  below) this AKA  will be used  otherwise your main-address.
  223.          Note,  that this switch only affects  mails from UNLISTED systems
  224.          (NOT listet in your AKA-matching-table).
  225.  
  226.        o KILL  -  tell me,  whether to  set  the kill/sent-flag  (let your
  227.          mailer delete the message after being sent) or not.
  228.  
  229.        o MARK  as  received  -  please specify  whether  an  ANSWERED mail
  230.          should  be marked as received (tell  other programs you have read
  231.          it!)  or not.  This could  be useful  if you  run e.g.  TrackM or
  232.          another  program  which  will  move  received  mails  to  another
  233.          directory!  Another  point  of  view is  that  ONTOUR  will never
  234.          answer a received mail! (Unless the /R parameter is used.)
  235.  
  236.        o SKIP  KLUDGES -  if ONTOUR replys  to a  netmail and uses  one of
  237.          your defined  TEMPLATES it will by default insert the kludgelines
  238.          of the  original message into the %MESSAGE% macro. (The format of
  239.          the  'quotet'   kludgelines  is  e.g.:  @INTL  2:240/3  2:240/11)
  240.          Setting  this option to YES will  prevent ONTOUR from quoting the
  241.          kludges.  IMPORTANT NOTE: this option  affects the calculating of
  242.          the  message-length! Be aware of this  when entering the next two
  243.          options:
  244.  
  245.        o Minimal  length:  if  you  specify  any  value here,  ONLY  mails
  246.          greater  or equal this  value (in bytes) will  be processed. Only
  247.          the  MESSAGETEXT is counted,  and (if SKIP KLUDGES  is set to NO)
  248.          the kludgelines.
  249.  
  250.        o Minimal  length of FREQUEST  and ATTACH mails: if  set to 0, this
  251.          option  disqualifies filerequest and  -attach messages from being
  252.          answered.  Setting  it  to  any  value  greater  than  the  first
  253.          "Minimal  length" option means: answer all  normal mails that are
  254.          greater  or equal than "Minimal  length" (bytes) but filerequests
  255.          only  if they are greater or equal  this value! That prevents you
  256.          from answering  those shitty freq-messages "* Reply to message in
  257.          blabla ...." without any important text!!!
  258.  
  259.        o ONCE-ONLY: if  you set this switch to "yes" every person will get
  260.          only  one (!)  response-mail  regardless how  often he  writes to
  261.          you.  The next time you start S_ONTOUR  you will be asked whether
  262.          to  delete the 'ONCE-ONLY-CHECKFILE'. This is  the only method to
  263.          answer  again  mails from  persons  who have  already  received a
  264.          response!
  265.  
  266.        o CRASH-handling:  here you  can  decide how  ONTOUR will  react on
  267.          crashmails! The following mails are treated as crash-mails:
  268.  
  269.          1.) the CRASH - bit is set.
  270.          2.) a ^AFLAGS IMM or
  271.          3.) a ^AFLAGS DIR kludge line is present
  272.  
  273.          If  you  decide to  ROUTE  your automatic  answer,  the %MESSAGE%
  274.          macro  will be  disabled and  one standard-line will  be inserted
  275.          insteed.  Why that? It's  simple: if somebody sends  you your new
  276.          key  via  crashmail and  you are  quoting  the original  text via
  277.          ONTOUR, the whole net will be informed ;-)
  278.  
  279.  
  280.  
  281.  
  282.                                  ONTOUR - page 5
  283.  
  284.          Alternatively  you can send your answer  CRASH (crash-bit set) or
  285.          DIRECT (^AFLAGS DIR) or simply don't answer crash-mails!
  286.  
  287.          Many  thanks  to  Carsten  Schroeder  (2:240/520)  for this  very
  288.          important hint!
  289.  
  290.        o ANSWER-DELAY:  if you enter a number  greater then 0, ONTOUR will
  291.          wait  these  number  of  DAYS  before  answering a  new  netmail!
  292.          (Thanks  to Reinier de Groot for  this suggestion!). This is done
  293.          by  comparing the *.MSG  - timestamp against the  actual time AND
  294.          against  the ONTOUR.DTI  -  timestamp. Leapyears  are considered!
  295.          BUT  NOTE: this ANSWER-DELAY  is only  used, if you  are at home!
  296.          (AT-HOME-SWITCH  set to YES)  If you are NOT  at home, mails will
  297.          be answered immediatly.
  298.  
  299.          The  actual  time and  date  MUST  match <Filedate  +  DELAY> (or
  300.          higher)  *AND* the  ONTOUR.DTI timestamp  MUST match  [NOT higher
  301.          than <Filedate  + Delay>]. (If the ONTOUR.DTI-timestamp is higher
  302.          than  <Filedate  +  Delay>,  then  this  message must  have  been
  303.          already processed!)
  304.  
  305.          If  you use a  tool that touches your  netmail-messages again and
  306.          again, these  mail would never been answered. (But don't worry, I
  307.          don't  know such a  tool ;-)  ANSWER-DELAY  and all time-checking
  308.          will be disabled by using the command-line-switch "/F".
  309.  
  310.        o SYSOP IS AT  HOME :-) --- this is the 'main-switch' of ONTOUR. If
  311.          set  to YES *AND*  ANSWER-DELAY is set to  0, no incoming netmail
  312.          will  be answered! If  you use this  switch, there is  no need to
  313.          alter your  batchfile! Just set it to NO  if you go on vacations.
  314.          (Take care of the combination AT HOME <> ANSWER-DELAY!)
  315.  
  316.        o SWITCH-DATE: you  can define a date to switch the AT HOME setting
  317.          of  ONTOUR! Example:  you set  AT HOME  to NO, define  an ANSWER-
  318.          DELAY  of 2  and set  SWITCH-DATE to  30.08.1992. You go  on tour
  319.          from  20.08.1992 to 02.09.1992.  From 20.08-30.08  ALL mails will
  320.          be  answered   immedialty!  From  01.-02.09  the  mails  will  be
  321.          answered  with a 2-days-delay,  so you have the  chance to answer
  322.          them  manually if you  are back in  time! (If you  will come back
  323.          later,  e.g. on 05.09.,  the mails  will be answered  by ONTOUR!)
  324.  
  325.          If  you define  a  date, it  will be  shown in  different colors:
  326.          dates in  the past are shown in darkgray (error!), the color will
  327.          change at day-number 30, 60 and 90 from today!
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.                                  ONTOUR - page 6
  353.  
  354.        Now let's go to the NOTIFY - section:
  355.  
  356.        o just  before you go  ON TOUR, it could  be a good  idea to notify
  357.          closed  friends, your  uplinks or  your points!  You can  do this
  358.          here by  defining (and creating) a notify-textfile, defining your
  359.          AKA  to use and just  pressing ENTER on the  'NOTIFY NOW' - line.
  360.  
  361.  
  362.          Please  create  a  textfile  (you can  do  this  by pressing  F10
  363.          *after*   defining  the  filename)   in  the  standard-textfiles-
  364.          directory.  This file  *MUST* contain  4 lines per  node. Between
  365.          this 4  line there may be *NO* empty  line! One node-entry can be
  366.          seperated  from the next by inserting  one or more lines startung
  367.          with a ";". (See example in NOTIFY.ARJ)
  368.  
  369.          1. line:        the name of the node to notify
  370.  
  371.          2. line:        his/her FIDO-adress and *optinally* one or more
  372.                          of this flags:
  373.                          CRASH -> make a crash-mail
  374.                          IMM   -> send it out IMMEDIATELY
  375.                          K/S   -> kill after sending
  376.                          HOLD  -> put it on hold
  377.                          example: 2:240/21 crash imm k/s
  378.  
  379.                          NOTE: if you have "KILL MSGS" in the
  380.                          Bit-settings menu set to yes, the new message
  381.                          will be killed after sending even if you don't
  382.                          write K/S!
  383.  
  384.          3. line:        the SUBJECT-LINE of the new message
  385.  
  386.          4. line:        the textfile to send to this node (*NOTE*: you
  387.                          can specify a FULL pathname. If you specify only
  388.                          a filename, the standard-textfiles directory is
  389.                          assumed!)
  390.  
  391.                          This textfile may contain the following MACROS:
  392.                          
  393.                          %FIRSTNAME%  -> the first name of the node
  394.                          %FULLNAME%   -> the node's full name (as
  395.                                          specified in line 1)
  396.  
  397.          I think, two macros should be enough for notification reasons.
  398.  
  399.  
  400.  
  401.        Next switch to the ADDRESS-SCREEN:
  402.  
  403.        o first  give me your  MAIN-Address. This address is  used to write
  404.          your response mails!
  405.  
  406.          When you  are a registered user of ONTOUR, you  can enter up to 9
  407.          AKAs (10 addresses,  1 main + 9 AKAs). THIS IS NOT A RESTRICTION!
  408.          IT IS AN ADDITIONAL BONUS FOR REGISTERED USERS!!!
  409.  
  410.        o AKA-MATCHING  ---  this  is a  registered-only  feature.  You can
  411.          insert   up    to   20   ZONE:NET   -   combinations   (including
  412.          wildcarding!!)  and a matching AKA for  every entry. If a netmail
  413.          from one  defined ZONE:NET arrives, it will be answered with your
  414.          corresponding  AKA.     NOTE:  the "FOREIGN ZONES"  switch in the
  415.          systems-parameter  menu will  NOT affect  this mails.  That means
  416.          that  incoming mail  from one  system defined  here will  ever be
  417.          answered  correctly.  If  you set FOREIGN-ZONES to  NO only mails
  418.          from UNLISTED foreign systems will NOT be answered.
  419.  
  420.  
  421.  
  422.                                  ONTOUR - page 7
  423.  
  424.        o the  CO-SYSOP  screen is  very important.  If  (and only  if) you
  425.          specify  a name for your CO-SYSOP (may  be your own name!!!), ANY
  426.          answered  mail will be  forwarded to him/her  using the specified
  427.          address! The  mail will be sent using your AKA  or, if you type a
  428.          "*"  in  the  AKA-line,  using  the  ORIGINAL  writers  name  and
  429.          address.
  430.          The  next line is  also VERY  important! If you  set COPY-ONLY to
  431.          yes, NEVER  - under no circumstances - any mail will be answered.
  432.          The incoming  mail will only be forwarded to your cosysop! (So he
  433.          can do the job for you ;-)
  434.          NOTE,  that your  COSYSOP can write  as many  mails to you  as he
  435.          wants  to!  He  will  NEVER  get  a  reply from  ONTOUR.  Carsten
  436.          Schroeder (2:240/20)  requestet this and I think it was a usefull
  437.          hint.
  438.  
  439.  
  440.  
  441.        Next switch to the NAMES-SCREEN:
  442.  
  443.        - please  fill in your  name(s). NOTE,  that ONTOUR will  only scan
  444.          for  mails addressed to  one of  this names, *NOT*  for your name
  445.          specified  in SYSTEM-PARAMETERS!   THE FIRST NAME  IS YOUR *REAL*
  446.          REGISTRATION - NAME!  This *must* be the same as you sent me with
  447.          your registration-form! Take this in mind!
  448.  
  449.          F10  toggles the checking-method from  strong (Names must exactly
  450.          match!)  to relaxed (name  can be anywhere within  the TO-line of
  451.          the  message)!  This is  new  since  version 1.10a!  e.g.  if you
  452.          insert "Peter"  as your name and choose RELAXED, ALL MAILS TO ALL
  453.          PETERS WOULD BE ANSWERED!!!
  454.  
  455.  
  456.          --->>>  NOT THE  NAME YOU'VE  ENTERED IN  THE "SYSTEMS-PARAMETER"
  457.          MENU  IS THE REGISTRATION NAME BUT THE  FIRST NAME IN THE "NAMES-
  458.          SCREEN" !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  459.  
  460.        - Some points asked  me for this and I have added the capability to
  461.          answer  *EVERY* incoming  mail  regardless of  the name.  This is
  462.          *ONLY*  usefull for points. They will  normally receive only mail
  463.          to their  own! To activate this function, place  a "*" as name in
  464.          one of the lines.
  465.  
  466.        WARNING: DO NOT USE THIS FUNCTION IF YOU ARE A NODE !!!!!! ;-)
  467.  
  468.  
  469.  
  470.        The SPECIAL-TEXTFILES-SCREEN:
  471.  
  472.        - here  you can define up to 15  specific response templates and up
  473.          to  3 nodes  for  each template.  Just press  ENTER, fill  in the
  474.          filename  (without path), and  insert the  nodes you want  to get
  475.          this  file  instead  of  the  standard-file  (defined in  SYSTEM-
  476.          PARAMETERS).  That's  all.  BUT  DON'T  FORGET  TO  GENERATE  THE
  477.          FILES :-)
  478.  
  479.        # please  don't worry,  but in  the unergistered-mode you  can only
  480.          define  ONE extra  template with  ONE extra  address. Registering
  481.          ONTOUR  will bring up all of  the additional, powerfull features.
  482.          Take  in  mind that  ONTOUR is  NOT  crippled! This  features are
  483.          mentioned  as a BONUS for  you, if you take  the time to register
  484.          with me.
  485.  
  486.          The  very powerful matching  - algorithm  allows you to  select a
  487.          wide  range of  combinations.  e.g. you  can make  2:240/21.2 get
  488.          another  filename  than  2:240/500.3,  2:240/500.0  (the  chef:-)
  489.  
  490.  
  491.  
  492.                                  ONTOUR - page 8
  493.  
  494.          should get the  same as 2:512/149 and all other 2:240/xx - node a
  495.          third one. To do so, just define 4 templates.
  496.  
  497.          Combine  2:240/500.2 with  template 1, 2_240/500.3  with template
  498.          2,  2:240/500 and  2:512/149 with  template 3 and  2:240/*.* with
  499.          template  4. As you  see, the  combination of NODE=*  AND POINT=*
  500.          will  make all  nodes and  points of  this ZONE:NET that  are NOT
  501.          defined  elsewhere get this template (if  there is no matching in
  502.          any  way, the  standard template  will be  sent, if  this doesn't
  503.          exist a hard-coded text).
  504.  
  505.          Within this screen there are 2 additional keys available:
  506.  
  507.          - pressing  T  will  bring  up  a  window,  answering you  for  a
  508.            nodenumber  to  test.  You  can  enter  a valid  nodenumber  an
  509.            ONTOUR-SETUP will  show you the matching file for this node. So
  510.            you can easily verfiy your settings!
  511.  
  512.          - pressing  F  will  scan  for all  defined  files  and mark  the
  513.            existing ones with an √ - sign.
  514.  
  515.            BUT NOTE: this  feature will be disabled, if you set AT HOME to
  516.            YES  *AND* have  defined an  ANSWER-DELAY *AND* have  defined a
  517.            DELAY-TEXTFILE!
  518.  
  519.  
  520.  
  521.        The EXCLUDE-SCREEN:
  522.  
  523.        - are  there  any nodes  who should  NOT  get a  response  mail? No
  524.          matter  - define them  here! It's a  good idea to  define some so
  525.          called  ROBOTNAMES, too. e.g.  AREAFIX or D'BRIDGE.  You can give
  526.          me up to 15 names.
  527.  
  528.  
  529.          SPECIAL  NOTE: every NAME is CaSeINSenSiTIve!  In every case! And
  530.          also  PARTIAL  names will  match!  If  you define  "AL"  as name,
  531.          "ALBERT"    will   match    as   well   as    "CARSTEN   BALDER"!
  532.          T A K E  C A R E  O F  T H I S !!!
  533.  
  534.          Another   "NOTE":  there   are  a  few   text-strings  predefined
  535.          (hardcoded)  so  you  don't  have to  take  care  about them.  At
  536.          present this are:
  537.  
  538.          - GECHO                (for   Gerard   van   der   Land's  famous
  539.                                 echomail-processor!)
  540.          - AREAFIX              (you know what this is :-)
  541.          - AREALINK
  542.          - ARCMAIL              (if  you  TOSS  before  ONTOUR this  entry
  543.                                 would be redundant, but who knows ... .)
  544.          - D'BRIDGE             (the second available mailer :-))
  545.          - IMAIL
  546.          - FMAIL
  547.          - RAID
  548.          - JAMESMGR             THE famous file-echo-manager ;-)
  549.  
  550.          If  there is any  other file- or echo-robot  replying to you, you
  551.          can exclude it by specifying it's name (or a part of it!) here.
  552.  
  553.  
  554.  
  555.        The EXCLUDE-TEXT-SCREEN:
  556.  
  557.        - These entrys are  treated in a special way. If one of these texts
  558.          EXACTLY  appears  anywhere  in  the  TEXT-BODY  of  the  original
  559.  
  560.  
  561.  
  562.                                  ONTOUR - page 9
  563.  
  564.          message,  these message won't  be answered in any  way. NOTE that
  565.          these  texts ARE case-sensitive! You can  enter the most control-
  566.          codes  as well. Example: "^APID: ghost"  (press CONTROL-A for ^A)
  567.          will  NEVER answer ANY  mail containing the kludge  line from the
  568.          GHOSTWRITER  <tm> in it. As well you  can enter "File missing" as
  569.          text  and  ONTOUR will  never answer  FrontDoor's  <tm> 'failed'-
  570.          messages.  If  the  first char  of  a  line is  '@',  it  will be
  571.          translated  to #1 (the first char  of any kludgeline). This makes
  572.          it a little bit easier to enter kludges.
  573.  
  574.        - one entry  must not be defined seperatly but is used hardcoded by
  575.          default:  "^APID: ONTOUR" :-)  That meens that you  must not take
  576.          care about,  that two ONTOURs will reply each other ping-pong :-)
  577.          in  the case  that both sysops  are on  vacation and one  of them
  578.          wrote a 'last-minute-letter'.
  579.  
  580.  
  581.  
  582.        MSBSCAN-Parameters:
  583.  
  584.        - Please read  the extra DOC included in this package. One note: if
  585.          you define a  *.MSG - path here, ONTOUR will look there for mails
  586.          to  answer, too! This way you  can use this path  even if you not
  587.          use  MSBSCAN itself  (and have two  different netmail-directories
  588.          for ONTOUR).
  589.  
  590.  
  591.  
  592.        QUIT!
  593.  
  594.        - yeah,  what could  that be  ;-) Just  quit the  setup-program and
  595.          store  any  made  changes  (you can  decide  not  to store,  when
  596.          answering the question with 'N'.)
  597.  
  598.  
  599.        NOTE:  You can leave  every menu with  the ESC -  KEY. The ADDRESS-
  600.        fields  anywhere in the  program can  be DELETED with  the DEL key!
  601.        BUT BE  AWARE: NO QUESTION IS ASKED!               Pressing F1 from
  602.        the  mainmenu will bring up some  VERY little information about the
  603.        beta-team ...  :-)
  604.  
  605.  
  606.  
  607.        REGISTRATION:
  608.  
  609.        o Yeah!   Great!   Your  decison   is  wise!   Please   enter  your
  610.          registration code  here, this enables the AKA-matching-system and
  611.          all of the very powerfull templates!
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.                                  ONTOUR - page 10
  633.  
  634.        ---  There is a little bonus for  FrontDoor<tm> users. If you start
  635.        the setup  program S_ONTOUR the first time, it will ask you whether
  636.        to  import some (SOME!) settings from  the FrontDoor-setup. You can
  637.        import  at EVERY time  later by typing "S_ONTOUR  IMPORT"! For this
  638.        you  MUST have  defined  the environment  variable FD=  (you should
  639.        have  some if you are using  FD :-))  NOTE, that  ALL your AKAs are
  640.        imported  but in the  unregistered mode  only the MAIN-AKA  will be
  641.        used!
  642.  
  643.  
  644.  
  645.  
  646.  
  647.         │ 3. part of the journey.
  648.         │ The RUN
  649.         └─────────────────────────────────────────────
  650.  
  651.        To  run the MAIN-program,  simply call  it! That's all.  All needed
  652.        information  will  be  catched  from  ONTOUR.PBS,  the  setup  file
  653.        generated  by  S_ONTOUR.EXE. Normally  you should  insert  the call
  654.        into your  MAIL-IMPORT - batchfile BEFORE calling any other program
  655.        that could move your netmail away :-)
  656.  
  657.        But there are a few <optional> parameters:
  658.  
  659.        - /?  --  show this parameters :-)
  660.  
  661.        - /M  --  force MONOCHROME - mode (also valid for S_ONTOUR)
  662.  
  663.        - /R    --   normally  ONTOUR  will *NOT*  answer  already RECEIVED
  664.          mails.  With  this  parameter  you can  override  this  logic and
  665.          received mails will be answered, too.
  666.  
  667.        - /C   --   answer EVERY matching mail  even if there  is already a
  668.          calculated CRC-checksum for it.
  669.  
  670.        - /L  --   TOGGLE the setting of the LOCAL-mail switch! If you have
  671.          enabled LOCAL mail, /L will disqualify them and vise versa.
  672.  
  673.        - /F   --  this switch  will force a complete  scan of your netmail
  674.          directory.  Normally ONTOUR will  ONLY recognise  mails that have
  675.          received AFTER  the last ONTOUR - RUN.               NOTE: ONTOUR
  676.          will create  a file called ONTOUR.DTI every time you run it. This
  677.          semaphore-file  will be placed  in ONTOUR's HOMEDIRECTORY. Please
  678.          do NOT delete it, unless you want a complete rescan.
  679.  
  680.        You can enter the parameters with a SLASH or with a minus-sign!
  681.  
  682.        ONTOUR  will exit with  various ERRORLEVELs that allow  you e.g. to
  683.        call your NETMAIL-packer...
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.                                  ONTOUR - page 11
  703.  
  704.        ERRORLEVEL        meaning
  705.        -----------------------------------------------------------------
  706.  
  707.         0                OK  -- NO response message generated
  708.  
  709.         3                Urps! Control-file not found, use S_ONTOUR
  710.  
  711.         4                The control-file is INVALID, use S_ONTOUR
  712.  
  713.         5                The (existing)  CRC-file is damaged (should never
  714.                          occur)
  715.  
  716.         6                Very  strange error writing  the CRC-file (should
  717.                          never occur)
  718.  
  719.         7                Not  enough  memory  on HEAP!  UPS  -->  can only
  720.                          occur  if you have  a 128KB - machine  :-) or are
  721.                          using ONTOUR in a level-8-shell :-)
  722.  
  723.        100               OK  -  response  message  GENERATED  --> you  can
  724.                          decide to call e.g. GECHO PACK
  725.  
  726.  
  727.  
  728.  
  729.  
  730.         │ 4. part of the journey.
  731.         │ The TEMPLATES
  732.         └─────────────────────────────────────────────
  733.  
  734.        TEMPLATES  are the plain  ascii files  to send. You  can write what
  735.        you  want to.  In the  current release  of ONTOUR  you can  use the
  736.        following MACROS:
  737.  
  738.        macro           meaning/replacement
  739.        -----------------------------------------------------------------
  740.  
  741.        %FIRSTNAME%     the first name of the person who wrote the mail
  742.  
  743.        %LASTNAME%      the same person's lastname
  744.  
  745.        %DATE%          the current date in the format: "13 Jun 92"
  746.  
  747.        %TIME%          the current time in the format: "22:41:12"
  748.  
  749.        %SYSOP%         the  name  you have  defined  as YOUR  NAME  in the
  750.                        SYSTEM-PARAMETER-SCREEN!   If  this  name   is  not
  751.                        defined, the original TO-name will be used.
  752.  
  753.        %TONAME%        the  TO-name of the  original message.  If you have
  754.                        defined  some  aliases  (in  the NAMES-SCREEN)  and
  755.                        there  comes  a  message to  one  of  your aliases,
  756.                        %TONAME% will be filled with your alias-name.
  757.  
  758.        %MESSAGExxx%    insert  the  original  message  itself  in the  new
  759.                        message!  If you  specify  xxx (a  decimal number),
  760.                        then  only the  first xxx  lines will  be inserted.
  761.                        e.g.:  %MESSAGE20%   ->  insert  20  lines  of  the
  762.                        original message!  If you have enabled the 'kludge-
  763.                        quoting'  (default),  the kludgelines  are counted,
  764.                        too.   For  the  whole   message  insert  %MESSAGE%
  765.                        NOTE:  ALL OTHER TEXT  IN THE  LINE CONTAINING THIS
  766.                        MACRO  WILL  BE IGNORED!!!!  AT NO  CASE  MORE THAN
  767.                        32000      BYTES      WILL      BE     EXPORTED!!!!
  768.  
  769.  
  770.  
  771.  
  772.                                  ONTOUR - page 12
  773.  
  774.                        If the  original message has paragraphs without the
  775.                        NEWLINE-mark  (#13), one  line  will be  assumed to
  776.                        have  80 characters. This may  result in having one
  777.                        additional   line  in   your  quote   (because  the
  778.                        reader's editor may wrap the lines).
  779.  
  780.        %MESSLEN%       this  macro  returns  the  physical  length of  the
  781.                        original  message. If you have  set SKIP KLUDGES to
  782.                        NO, they will also be counted!
  783.  
  784.        %MESSDATE%      returns the date/time of the original message.
  785.  
  786.        %SYSTEM%        the callings system ADDRESS in the format 2:240/11
  787.  
  788.  
  789.  
  790.        Further  you can  insert ANY  valid environment variable  into your
  791.        templates.  This is a  VERY POWERFUL AND FLEXIBLE  method of making
  792.        one template  for many vacations! For example you write a line like
  793.        this:
  794.  
  795.                  I am ON TOUR in %%place%, and will be back soon!
  796.  
  797.        Now you  must define the environment variable PLACE by typing (from
  798.        the DOS PROMPT AND NOT FROM WITHIN A SHELL!!!): SET PLACE=Munich
  799.  
  800.        The above line will now be replaced by:
  801.  
  802.                   I am ON TOUR in Munich, and will be back soon!
  803.  
  804.        You  can use EVERY  environment variable, e.g.  %%COMSPEC%, too :-)
  805.        You  only have  to take care,  that the  macro is preceeded  by TWO
  806.        %-signs! NOTE:  if the variable does NOT exist, ONTOUR will replace
  807.        your macro with (???).
  808.  
  809.        You have the  ability to insert a TEARLINE in your template! If one
  810.        line  is starting with  three dashes  ("---"), no standard-tearline
  811.        will   be   generated.   (Of  course,   the   PID-Kludge   is  EVER
  812.        inserted....)  NOTE: if  you register  ONTOUR the definition  of an
  813.        own tearline will result in skipping ONTOUR's own one....
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.                                  ONTOUR - page 13
  843.  
  844.         │ 5. part of the journey.
  845.         │ Address - logic
  846.         └─────────────────────────────────────────────
  847.  
  848.        Allow me  some words about how ONTOUR will  find out the address of
  849.        the  original mail. If there is  a ^aMSGID-Kludge, the address will
  850.        be  taken from here. If not, ONTOUR  will look for an ^aINTL-Kludge
  851.        and  tries to get it  from there. If this  second method fails, the
  852.        address will be  taken from the message-bits - BUT ONLY THE NET AND
  853.        THE  NODE-NUMBER! In that  case the  response mail will  be sent to
  854.        your  own  MAIN-ZONE!  The POINT-Information  is  grabbed  from the
  855.        ^aFMPT-Kludge  only and will be inserted  into the response mail as
  856.        a  ^aTOPT-Kludge. (If  you  are a  point yourself,  a ^aFMPT-Kludge
  857.        will be inserted in the response mail, too.)
  858.  
  859.        The method  choosen will be reported in the logfile by inserting an
  860.        [MSGID], [INTL ] or [BITS ] - tag in it.
  861.  
  862.  
  863.  
  864.  
  865.  
  866.         │ 6. part of the journey.
  867.         │ Legal stuff
  868.         └─────────────────────────────────────────────
  869.  
  870.        As  you know,  I will  guarantee NOTHING.  You use this  program at
  871.        your own risk.  I've tried to make this program as save as possible
  872.        -- but who knows?! If you detect any error, please report it!
  873.  
  874.        Here's my FIDO-address again:
  875.  
  876.        GRANNY's INN ,  2:240/11      BBS-number: 49-4441-5404, online 24h
  877.  
  878.  
  879.  
  880.  
  881.                                Last, but not least:
  882.  
  883.                    THIS PROGRAM IS SHAREWARE! IT IS *NOT* FREE!
  884.  
  885.        I've made  many programs, declared as POSTWARE (people have only to
  886.        send  a  postcard!).  The  resonance  was  NOT  satisfactory!  Many
  887.        persons  are using my  SITEINFO (a utility for  FrontDoor, the HIGH
  888.        RELIABLE  MAILER) but  only  12 have  sent a  card until  today :-(
  889.        So  I've decided  to take a  VERY little  amount of money  for this
  890.        program. ONTOUR  can be VERY useful for you, so  it is not too much
  891.        to pay 15 DM (Deutsche Mark) for it!
  892.  
  893.        If  possible,  please  pay  in  german  currency.  If you  have  no
  894.        possibility to  get some D-Mark, calculate the corresponding amount
  895.        in your own currency and pay it ;-)
  896.  
  897.  
  898.  
  899.        There are two ways for payment:
  900.  
  901.        - send your money direct to: (preferred)
  902.  
  903.                                Peter Hampf
  904.                                Graf von Galen Strasse 27
  905.                                D-2848 Vechta
  906.                                Germany
  907.  
  908.  
  909.  
  910.  
  911.  
  912.                                  ONTOUR - page 14
  913.  
  914.        - transfer it to my bank:
  915.  
  916.                                Volksbank Vechta e.G.
  917.                                BLZ (Bankleitzahl)      280 641 79
  918.                                Kto.-Nr. (Kontonummer)  126 758 200
  919.  
  920.        Together  with  your  payment send  me  the  REGISTRATION-FORM (via
  921.        electronic  mail or via  slow post).  That's all! I  will thank you
  922.        VERY  VERY much for  registering and can go  on developing programs
  923.        for you!
  924.  
  925.  
  926.  
  927.  
  928.  
  929.         │ 7. part of the journey.
  930.         │ Support and registration sites
  931.         └─────────────────────────────────────────────
  932.  
  933.        Dutch   people  can  register   this  package   with  Hans  Siemons
  934.        (2:512/149) from  PRIME productions. (If you don't know him, have a
  935.        look on his products!) Please contact:
  936.  
  937.                                Hans Siemons,
  938.                                Crogtdijk 1,
  939.                                4815 AD, Breda
  940.                                Nederland.
  941.  
  942.        A  dutch   registration  from  (ONTOUR.RNL)  is  included  in  this
  943.        package. Have a look on it for further information.
  944.  
  945.  
  946.  
  947.        The german support and registration site is Eckhart von dem Berge
  948.        (2:240/500 and 2:240/501)
  949.  
  950.                                Eckhart von dem Berge
  951.                                Meissenstraße 81
  952.                                3300 Braunschweig
  953.                                Germany
  954.  
  955.  
  956.  
  957.        You can obtain the latest version of ONTOUR by file-requesting the
  958.        MAGIC name "ONTOUR" at their addresses (and mine, of cource :-)
  959.  
  960.  
  961.  
  962.        Regards,
  963.        Peter
  964.  
  965.        P.S.: I know that there are many orthographical errors in this
  966.        document. Please don't read them :-)
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.                                 === SMALL INDEX ===
  985.  
  986.  
  987.  
  988.                      ^APID .............................9
  989.                      ADDRESS - LOGIC ..................13
  990.                      ADDRESS-SCREEN ....................6
  991.                      AKA-MATCHING ......................6
  992.                      ANSWER-DELAY ................2, 5, 8
  993.                      AT HOME ........................5, 8
  994.                      ATTACH ............................4
  995.                      BEHAVIOUR .........................3
  996.                      BITS .............................13
  997.                      CO-SYSOP ..........................7
  998.                      CRASH-HANDLING ....................4
  999.                      CRC32-CHECKSUM ....................2
  1000.                      DELAY-TEXTFILE .................2, 8
  1001.                      EDITOR ............................3
  1002.                      EMS/XMS SWAPPING ..................3
  1003.                      ERRORLEVEL .......................11
  1004.                      EXCLUDE-SCREEN ....................8
  1005.                      EXCLUDE-TEXT ......................9
  1006.                      F1 ................................9
  1007.                      FOREIGN-ZONES .....................4
  1008.                      FREQUEST ..........................4
  1009.                      IMPORT ...........................10
  1010.                      INBOUND ...........................3
  1011.                      INTL .............................13
  1012.                      INTL-KLUDGE .......................4
  1013.                      KILL ..............................4
  1014.                      LEGAL STUFF ......................13
  1015.                      LOCAL-MAIL ........................3
  1016.                      LOG-FILE ..........................3
  1017.                      MARK ..............................4
  1018.                      MINIMAL LENGTH ....................4
  1019.                      MSBSCAN-PARAMETERS ................9
  1020.                      MSGID ............................13
  1021.                      NAMES-SCREEN ......................7
  1022.                      NOTIFY ............................6
  1023.                      ONCE-ONLY .........................4
  1024.                      PASSWORD ..........................3
  1025.                      PAYMENT ..........................13
  1026.                      QUIT! .............................9
  1027.                      REGISTRATION ......................9
  1028.                      REMOTE-MAINTAINANCE ...............3
  1029.                          OTREMOTE ......................3
  1030.                      REMOTE-PASSWORD ...................3
  1031.                      RESCAN-SEMAPHORE ..................3
  1032.                      ROBOTNAMES ........................8
  1033.                      SKIP KLUDGES ......................4
  1034.                      SPECIAL-TEXTFILES-SCREEN ..........7
  1035.                      STANDARD-TEXTFILE .................2
  1036.                      SUPPORT AND REGISTRATION .........14
  1037.                      SWITCH-DATE .......................5
  1038.                      SYSTEM PARAMETERS .................2
  1039.                      TEMPLATES ........................11
  1040.                          MACRO ........................11
  1041.                      TEXTFILE-DIRECTORY ................2
  1042.                      THE RUN ..........................10
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.